/*-
 * Copyright (c) 2008-2010, Oleg Estekhin
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions are met:
 *
 *  * Redistributions of source code must retain the above copyright notice,
 *    this list of conditions and the following disclaimer.
 *  * Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the distribution.
 *  * Neither the names of the copyright holders nor the names of their
 *    contributors may be used to endorse or promote products derived
 *    from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE FOR
 * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
 * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
 * DAMAGE.
 */

package oe.assertions.util;

import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

/** Contains static factory methods for creating {@code List}s from a set of objects. */
public final class ListUtils {

    /**
     * Returns a list that contains the specified elements.
     *
     * @param first an element
     * @param second another element
     *
     * @return a list view of the specified elements
     *
     * @throws IllegalArgumentException if {@code first} or {@code second} is {@code null}
     */
    public static <T> List<T> asList( T first, T second ) {
        if ( first == null ) {
            throw new IllegalArgumentException( "first is null" );
        }
        if ( second == null ) {
            throw new IllegalArgumentException( "second is null" );
        }
        @SuppressWarnings( "unchecked" )
        List<T> list = Arrays.asList( first, second );
        return list;
    }

    /**
     * Returns a list that contains the specified elements.
     *
     * @param first an element
     * @param second another element
     * @param third another element
     *
     * @return a list view of the specified elements
     *
     * @throws IllegalArgumentException if {@code first}, {@code second} or {@code third} is {@code null}
     */
    public static <T> List<T> asList( T first, T second, T third ) {
        if ( first == null ) {
            throw new IllegalArgumentException( "first is null" );
        }
        if ( second == null ) {
            throw new IllegalArgumentException( "second is null" );
        }
        if ( third == null ) {
            throw new IllegalArgumentException( "third is null" );
        }
        @SuppressWarnings( "unchecked" )
        List<T> list = Arrays.asList( first, second, third );
        return list;
    }

    /**
     * Returns a list that contains the specified elements.
     *
     * @param first an element
     * @param rest the rest of elements
     *
     * @return a list view of the specified elements
     *
     * @throws IllegalArgumentException if {@code first} is {@code null}
     * @throws IllegalArgumentException if {@code rest} is {@code null} or contains {@code null} elements
     */
    public static <T> List<T> asList( T first, T... rest ) {
        if ( first == null ) {
            throw new IllegalArgumentException( "first is null" );
        }
        if ( rest == null ) {
            throw new IllegalArgumentException( "rest is null" );
        }
        List<T> list = new ArrayList<T>( 1 + rest.length );
        list.add( first );
        for ( T element : rest ) {
            if ( element == null ) {
                throw new IllegalArgumentException( "rest contains null" );
            }
            list.add( element );
        }
        return list;
    }


    private ListUtils() {
    }

}
